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•PROGRAM DESCRIPTION 

The disk diagnostic program enables the user to 1) excerise all positioning and 

data transfer functions provided by the formatter, 2) check all status and error 

flags returned by the formatter, 3) verify proper operation of all units connected 

to the formatter, 4) verify proper operation of the coupler functions, and 5) check 

that part of the computer interrupt system used by the formatter. Some of the 

tests included in the diagnostic are designed to isolate errors which depend on the 

data content or length of a data transfer. Another set of tests are devoted to forcing 

error conditions and checking that they are properly reported by the controller. Tests 

also provided to check for proper sector formatting and unit to unit compatibility. 



are 



Error reporting is accomplished via the console teletype. In general, errors are 
reported when either status information or data input from the formatter differ from 
that expected by the program. The operator has the ability to inhibit error message 
outputs as required. In addition, the operator specifies the order in which tests are 
performed and the sequence in which certain tests select units. 

The program operates in a minimum memory configuration of 4K but will automatically 
utilize extra memory to test DMA addressing. The upper 200 g words of memory are 
reserved by the program for loaders and are not overwritten. 
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OPERATING INSTRUCTIONS 

The diagnostic executes in a sequence of well defined steps that are described 
below. All communications between the operator and the program are via the 
console teletype and, in some cases, the computer switch register. All replies 
to specific input requests are entered from the keyboard and are terminated by 
the RETURN key. The program ignores any characters other than the 64 printing 
characters (including space), RUBOUT, RETURN, and the "break" characters 
Control-F, Control-P, Control-E, Control-T, and Control-N. 

Three of the recognized keyboard characters are input line-editing characters 
that may be used by the operator to correct errors made while typing. The editing 

characters function as follows: 

RUBOUT Deletes one character to the left for each input 

Q r and echoes back as\. 

SHI FT -L 

SHIFT-O Deletes the entire input line to the left and echoes 

back as *- . 

The break characters are used to alter the execution sequence of the diagnostic 



as follows: 

Control-F 

Control-P 

Control-E 

Control-T 

Control-N 



Echoes back as t F and then returns the program 
to the FMPR request (Step 3 below). 

Echoes back as t P and then returns the program to 
the PACK request (Step 4 below) 

Echoes back as t E and then returns the program to 
the EMSK request (Step 5 below) 

Echoes back as T T and then returns the program to 
the TEST request (Step 6 below) 

Echoes back as f N, stops execution of the test in 
Drocress, and then starts execution of the next test 
in the sequence specified by the last TEST request. 
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Not all of the break characters are recognized at each step in the program's 
execution sequence, therefore, those break characters that are recognized axe 
specifically indicated in the steps described below. 

All numeric values input to or output from the program, unless otherwise 
specified, are in octal. If more than 5 digits are input for a numeric value then 
the program will recognize only the low ordered 16 binary bits of the value specified. 

If any operator reply to an input request cannot be recognized by the program or is 
outside of the allowed set of values, then the program will output the error message 
and repeat the request. Similarly, for input requests in which the operator may input 
a variable number of parameters, the program will output the error message: 

TOO MANY 
and repeat the request if the number of parameters exceeds the maximum allowed. 

in the steps below, the symbols ^and } are used to enclose operator inputs that are 
optional. Examples that are given use underlining to indicate operator inputs and the 
symbol 2 to indicate a RETURN. 

1) Make sure the console teletype is on the LINE position and that 
each disk drive to be tested is loaded with a cartridge. Load the 
diagnostic using the Data General absolute binary loader. Once 
loaded, the program will automatically start execution at Step 2, 
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below. The user, however, may restart the program at memory location 
2 or 3. Restarting on Location 2, will proceed from Step 2 while restarting 
at Location 3 will proceed at the last parameter request (Step 3, 4, 5, or 6) 
output by the program. 

2) The program now types out the size and locations of the I/O buffers as: 

WBUF = a 

RBUF = b 

BUFL = c 

ENDM = d 

where a is the starting address of the write buffer, b is the starting 

address of the read buffer, c is the buffer length, and d is the address 

of the last memory location to be used by the program. Following this 

step the program enters its normal execution sequence. 

Example: WBUF =6210 

RBUF =6630 

BUFL =420 

ENDM = 17577 

The write buffer starts at 6210 g , the read buffer at 6630 gf the length 

of each buffer is 420 g , and the last memory location to be used is 17577 8 . 

3) The program requests the disk formatter configuration by typing: 

FMPR = 
The operator replies by entering from 2 to 5 numeric parameters in the form: 



w, 



where the individual parameters are defined as: 

w Number of words per sector 

s Number of sectors per track (revolution) 

b Number of bits per word 

d Device address of the formatter coupler 

i Number of the formatter coupler interrupt mask bit 



The parameters w and s must be specified and are normally entered as one 
of the following pairs: 



w 



■ J 

12 


400 


14 


16 


300 


20 


24 


200 


30 


32 


100 


40 



The parameters b, d, and i are optional, b should be either omitted or 
entered as 6, its default value, specifying 16 bits per word, d, if required, 
should be entered as an even number in the range 2-74 g . If omitted the 
default value of 30g will be assumed, i, if required, should be entered as a 
number in the range 0-17 g . If omitted a default value of 5 will be assumed. 
The program recognizes the break character Control-F during this step. 
Example: VMPR=300. 20 f . 34 2. 

Specifies the word per sector, sectors per track, and coupler 
device address as300g, 20 g , 34 g , respectively. 16 bits 
per word and an interrupt mask bit of 5 are both assumed. 
4) The program requests the identity and sequence of the packs to be tested 

by typing: 

PACK= 
The operator replies by entering from 1 to 8 pack identifiers, p, in the form- 



.{j P 2 {; P 3{' — ~ P n}\} 
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where each p has the form: 

u/r/e 
and where the individual parameters in p are defined as: 

u Unit Number 

r Pack Number 

e Cylinders to be used 

u specifies the unit number as a single digit in the range 0-3. For units 
having removable packs, r specifies the removable pack as the digit and 
the fixed pack, if present, as the digit 1. For units having only a single 
fixed pack, r specifies this pack as the digit . The parameter c specifies 
the cylinders to be used by the diagnostic and is entered as either c or Cl -c 2 
where c, c r and c 2 are cylinder numbers, and Cl is less than or equal to c 2 - 
In the first form cylinders through, and including, c will be used while in 
the second form cylinders c x through, and including, c 2 will be used. 

All of the pack identifiers are treated independently so that the user may specify 
different packs on the same unit and/or different cylinders on the same pack. 
The diagnostic will use only those packs and cylinders specified. 
The program recognizes the break characters Control-F and Control-P during 

this step. 

Example: PACK=.0W313 j Q/l/10-25. 0/i /200-247 A 

Specifies the following packs: 
Unit 0, Pack 0, Cylinders 0-313 g 

Unit 0, Pack 1, Cylinders I0 g - 25 8 
Unit 0, Pack 1, Cylinders 200 g -247 g 
Instead of the above format the operator may respond with Uj_ to 

enter the user-specified test mode, which is described at the end of this manual. 
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The program requests the parameters to be used to control error message 

printing by typing: 

EMSK= 
The operator replies by entering up to 2 parameters in the form: 

where the individual parameters are defined as: 

m Error word mask 

£ Verify detail line limit 

m is a 16 bit numeric value which is used to mask an error word that 
is generated by the program during each I/O or buffer compare operation. 
Each bit in the error word is assigned to a status indicator detected by the 
program and is set to a 1 if the detected status differs from the expected 
status. At the completion of the operation m is ANDed with the error word 
and, if the result is non-zero, an error message is printed describing the 
error. 

The bits are assigned to the error word, and thus to m, as follows: 

Bit value Interpretation 

Verify Error 
Interrupt Error 
Not Ready Error 
Write Protect Error 
Cylinder Address Error 
Preamble Check Error 
Time Out Error 
Format Error 
CRC Error 
Rate Error 

Bad Sector Flag Error 
Word Count Error 
Done/Busy Error 
Seek Error 



2 


20000 


3 


10000 


4 


4000 


5 


2000 


6 


1000 


7 


400 


8 


200 


9 


100 


10 


40 


11 


20 


12 


10 


13 


4 


14 


2 


15 


1 
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Any bits other than those described above are ignored by the program. 
If m is omitted a value of 177777 g will be used. 

I is a number that specifies the maximum number of detail lines to be 
output following a verify error message. If specified as 0, then no detail 
lines will be printed , if omitted, then all of the detail lines will be printed. 

The program recognizes the break characters Control-F, Control-P, and 
Control -E during this step. 

Example: EMSK= t _3)- 

Sets the error print mask to 177777 g , all 
errors, and the verify detail line limit to 3. 

The program requests the tests to be performed by typing: 

TEST= 
The operator replies by entering a sequence of test specifications, t, which 
specify the order in which the tests are to be executed. The sequence of test 
specifications permits the inclusion of nested test execution loops and is 
entered in any one of the following forms: 

t 
m*t 

(f) 
m* (f) 

where m is a number in the range 0-7777 8 and V is any one of the above 
forms. The simple forms t and <t<) specify just t and f, respectively. 
The forms m*t and m* (V), however, specify t and V , respectively, repeated 
m times while the form V v f 2 specifies the sequence f x followed by f 2 . 
As a result any of the following input sequences could be entered. 
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t 

m*t 

m l* < m 2* t> 

t lt m n 2 

t lf m 2 *t 2 , m 2 *<m 3 *t3) 

tl , m 1 *(t 2j m 2 *t 4 . m 3 *(t 5 , t 6 )), t ? 

etc. 
If m is entered as then the following t or V is repeated indefinitely. 
Parenthetical nesting of sequences may be used 4 levels deep. 



Each t can either be omitted or entered as either n or n x - n 2 



where 



n, n, and n £ are test numbers and n x is less than n,. The form n specifies 
the single test n while the form n, - » 2 specifies tests n v through, and in- 
eluding, n 2 - 



If t is omitted the default set of tests, 1-24, is specified. The allowed 



test numbers are as follows: 

Test Numbers 


1 
2 
3 
4 
5 
6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 



Test 

Check Sectors 
Format Sectors 
Verify Preambles 
Verify Sector Addressing 
Seek and Restore 
Write Range 
Read Range 
CRC Generation 
Memory Addressing 
Data Patterns 
Random Data 
Random Parameters 

Preamble Sector Compare Error 

Preamble Cylinder Compare Error 

CRC Compare Error 

Bad Sector Flag Error 

Write Protect Flag Error 

Time Out Error 

Cylinder Addressing Error 

Word Count Error 

Interrupt System 
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Test Number 3£§i 

25 Transfer Rate Error 

Write Protect Switch Error 
27 Not Ready Error 

30 Format Error 

n Automatic Program Load 

g 2 Miscellaneous Functions 

The program recognizes the break characters Control-F, Control-P, 
Control-E, and Control-T during this step. 

Example: TEST= 3* (1-2, 2*4, 2* (15,14)) , , 

Specifies the following sequence of tests: 

1, 2, 4, 4, 15, 14, 15, 14, 1, 2, 4, 4, 15, 14, 15, 14 

I, 2, 4, 4, 15, 14,15, 14, 1, 2, 3, 4, 5, 6, 7, 10, 

II, 12, 13, 14, 15, 16, 17, 20, 21, 23, 24, and 0. 

7) The program Proceeds to execute the tests specified in Step 6 on the packs 

specified in Step 4. When the specified test sequence is complete the program 
returns to Step 6. 

The program recognizes all of the allowed break characters during this 
step. 
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ERROR MESSAGES 

The printing of error messages is completely controlled by the operator via the er- 
ror word mask. Three types of error messages are output by the program, one as a 
result of status errors returned by the formatter (hardware errors), another resulting 
from errors in the data input from the formatter (verify errors), and a third resulting 
from errors in the interrupt system. 

The printing of hardware error messages is controlled by bits 4-15 of the error word 
mask. Bits 4-13 and 15 of the error word correspond to actual bits returned in the 
formatter status register, while bit 14 of the error word is set when an error is found in 
'the sequencing of the coupler BUSY/DONE flags. A further description of the status 
register bits and the BUSY/DONE sequencing can be found in the XDF-50 I/O Specification 
Manual. 

Following each operation performed by the diagnostic, the value of the error word is 
compared with the value that the program expects to receive at that point. If one or more 
bits in the register is other than expected and if the corresponding bit is set in the error 
word mask then a hardware error message is printed. 

Hardware error messages have the format: 

H ssss OP=o, www AD-u, p, ccc, t, ss ST-eeee, rrrr 

and are interpreted as follows: 

H ssss ssss is the current test state of the test in progress. 
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. _ OP=o, www o Is the disk operation that was performed and www is the 

word count specified for that operation . (The buffer address 
was WBUF for write operations and RBUF for read operations. ) 

AD=u, p, ccc,t,ss 

u is the disk unit number, p is the pack number, ccc is the 
cylinder number, t is the track number, and ss is the sector 
number . 

ST=eeee, rrrr 

eeee is the expected value and rrrr the received value of 

bits 4-15 of the error word. 

The printing of verify error messages is controlled by bit 2 of the error word mask 
and by the verify detail line limit. Verify error messages occur when data read in 
from the controller differs from that which is expected by the program. Each verify 
error message consists of one line to notify the operator that a verify error occured 
followed by a detail line for each data word in error. Verify error messages are 
printed only if bit 2 of the error word mask is set. The number of detail lines printed 
will always be less than or equal to the verify line limit. 

The format of these messages is: 

V ssss OP=o, www AD=u, p, ccc, t, ss EOnnnn 
aaaa eeeeee rrrrrr 



and is interpreted as follows: 
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-V 6SSS 

OP= o, www 



AD=u, p, ccc.t.ss 



EC=nnnn 

aaaa 

eeeeee 
rrrrrr 



bsss is the current test state of the test in progress. 

o is the last disk operation that was performed and 

www is the word count specified for that operation. 

(The buffer address was RBUF.) 

u is the disk unit number, p is the pack number, ccc is the 

cylinder number, t is the track number, and ss is the sector 

number . 

nnnn is the number of data words in error (i.e. , the number 

of detail lines to follow). 

is the address, relative to WBUF and RBUF, of the data 

word in error. 

is the expected data word from WBUF. 

is the received data word from RBUF. 



• * • «, thP ooerator may delete remaining detail lines by enter- 
Whenever detail lines are printing, the operator may 

, k ,h Tn this case the program will output * and continue 
ing any key from the teletype keyboard. In this ca.e tne p B 

with the test in progress. 

Th e printing of interrupt error usages is eontroUed b y bit 3 of the error word mask. 

These error usages occur d^iog the interrupt s y ste„ test (Test 24, „d indicate so m e 



form of interrupt failure. Interrupt error mes 
word mask is set. 



sages are printed only if bit 3 of the error 
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The format of these messages is : 
Is or I s, aa 

and is interpreted as follows: 

Is s is the state of the interrupt system test and indicates the type 

of error. 

aa (when present) specifies the address of a device which caused 

an interrupt. 

The interpretation of s is as follows: 
s Interpretation 

The disk DONE flag was not cleared by a clear (NIOC) function. 

1 An interrupt occured with all mask bits set and the disk DONE 
flag reset (from the previous NIOC). 

2 An interrupt occured with all mask bits set, except for that of 
the disk controller, and with the disk DONE flag reset (from the 
previous NIOC). 

3 An interrupt occured with all mask bits set and the disk DONE 
flag set (from a NOP operation). 

4 An interrupt did not occur with all mask bits set , except for that 
of the disk controller, and with the disk DONE flag set. 

5 An IORST instruction failed to clear the disk DONE flag. 
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JMTFR ACTIVE TESTS 

Four tests which require operator interaction are provided. These are: 
Tes t 25 Transfer Rate Error 

This test verifies that the formatter detects transfer rate errors, 
during both read and write operations, by initiating each operation 
and then halting the computer. The program will halt, and the 
operator should press CONTINUE, twice for each pack specification 
entered in response to the PACK request. 

Test 26 Write Protect Switch E rror Test 

This test verifies that the formatter detects the write protect switch 
and prevents writing when it is set. The program will type out: 

STWP u, p 
The operator should set the write protect switch for the unit and 
pack specified by u and p, and then press the teletype SPACE bar 
to continue. After the test is complete the program will type: 

CLWP u, p 
The operator should turn off the write protect switch for the 
selected pack and then press the SPACE bar to continue. 
The program will repeat this sequence for each pack specification 
entered in response to the PACK request. 
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Test 27 Not Ready Test 

This test verifies that the formatter detects a unit not ready condition. 

The program will type out: 

STNR u, p 
The operator should unload the unit specified by u, and then press the 
teletype SPACE bar to continue. After the test is complete the 

program will type: 

CLNR u, p 
The operator should reload the selected unit, wait until it is ready 
and then press the SPACE bar to continue. 

The program will repeat this sequence for each pack specification 
entered in response to the PACK request. 

Test 30 Format Error Test 

This test verifies that the formatter detects sector format errors. 
To execute this test a pack must be available that has fewer words 
per sector (more sectors per track) than the number for which the 
formatter is configured. 
The program will type out: 
LDFE u, p 
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Test 30 Format Error Test - C ontinued 

The operator should load the test pack into the unit specified 
by u, and then press the teletype SPACE bar. After the test is 
complete the program will type: 
ULFE u, p 

The operator should remove the test pack from the specified 
unit, replace it with a properly formatted pack, and then press 
the SPACE bar to continue. 

The program will repeat this sequence for each pack specification 
entered in response to the PACK request. 

Should the user desire to bypass the testing of a pack in Tests 26-30, a CONTROL-! 
should be entered for the setup request for that unit rather than the SPACE bar. The 
program will respond with an * and proceed to the next pack specified. 
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User-Speci fic Test Mode 

When the operator responds U^ 

to the PACK request, the diagnostic enters the user-specified mode. In this mode, 

the operator generates the disk command, expected status and status mask, 

data pattern, word count, and full disk address tor up to eight discrete functions. A 

combination of sense switch and teletype control allow looping on one step, repetition 

of all steps in order, and/or execution of one step followed by a pause before proceeding 

to the next step. 

The input phase involves two supplementaiy prompting messages, and Is similar to 

the FMPR. PACK, etc. requests. During the Input phase the control keys Control-N 

and Control-P are recognised (note that typing Control-P takes toe program back out 

of the user-specified test mode. ) 

The program requests the nth user-specified function by typing 

OP = 
and the operator replies with from one to five specifiers, separated by commas, 
where the specifiers are interpreted as 

op. code, word count, data pattern #, error status, mask 
respectively. If this is not the first user-specified function, the operator may respond 
'with a carriage return only to terminate the input phase and enter the execution phase. 
Otherwise the op code is specified as one octal digit which corresponds to the type of 
operation desired (e.g. 4 - diagnostic read, etc.) For operations involving transfer 
of the preamble and CRC words, these will be created automatically. The word count 
may be any number up to the sector size plus the preamble and CRC words. 
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The data pattern is a number In the range 0-6, where the patterns are those as 
described for the standard test sequences. The error status parameter is the 
value to be expected at the conclusion of the operation; the mask is similar to 
that requested by the EMSK request in the standard test procedure. Any or all 
parameters after the op code may be omitted, in which case the program supplies the 
standard value of for the pattern number and expected status, the value 7777 for the 
error mask, and leaves the word count at the value it had during the last operation. 

The program then requests disk addressing information by typing 

AD = 
and the operator replies with from two to five specifiers, in the sequence 

unit, pack, cylinder, track (surface), sector 
Only the unit and pack must be specified, and must be in the range 0-3 and 0-1, 
respectively. Any or all of the cylinder, track, and sector inputs may be 
omitted, in which case the program assumes the value 0. 

If less than eight functions have been defined, the program returns to ask for 
another OP; if eight functions have been input, or if the operator replies with a 
' carriage return to the OP request, the program enters the execution phase. 

'Example: 

QP = 6,400,3 s 
AD= 0^ 
OP = 3, 400 j 
AD=0j_ 
OP = ^. 

selects a diagnostic write of the "increasing count" data pattern, followed by a read, 
on sector 0, track 0, cylinder 0, of unit 0, pack 0. The adjustment to the word count 
entailed by the diagnostic writing will be done automatically by the choice of 
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operation "6". 

When the input phase has been concluded, the program enters the execution phase. 
(If execution was begun automatically after eight operations were entered, the 
program first types "EX".) During execution, the CPU switch register and the 
teletype are used to regulate the execution of tests, as follows: 

Switch May be set "on" to inhibit error printouts regardless of the masks 
that were specified. 

Switch 15 Is set "on" to inhibit execution of the next user-specified test 
step. As long as switch 15 is off, the specified tests will be 
performed repeatedly. Any teletype key (except tNor ? P) 
is used to override switch 15, causing the program to advance 
to the next step, disregarding the state of switch 15. 

In this context the "next" test is defined cyclically; after all tests have been executed, 
the first test in the list becomes the "next" test. 

If an error printout occurs the "state counter" will identify the test step which failed, 
starting with for the first test step in the list, up to a maximum of 7 if eight tests 
were specified during the input phase. 

The program will monitor the switch register and execute the specified test steps, 
• until Control-N or Control-Pis seen. Control-P causes exit from the user-specified 
test mode and returns to the PACK request; Control-N causes re-starting of the 
prompting phase, to allow specification of up to eight more test steps. 
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